Programming with QuickTime VR

| Previous | Chapter contents | Chapter top | Section top | Next |

QTVRUpdate

You can use the QTVRUpdate function to force an immediate update of a QuickTime VR movie image.

OSErr QTVRUpdate (QTVRInstance qtvr, QTVRImagingModeimagingMode);
qtvr
An instance of a QuickTime VR movie.
imagingMode
An imaging mode. See "Imaging Modes" for a description of the available imaging modes. You can specify the  kQTVRCurrentMode imaging mode to use the current imaging mode.
function result
A result code.

DESCRIPTION

The QTVRUpdate function immediately updates the image for the QuickTime VR movie specified by the qtvr parameter, without waiting for the next call to MoviesTask in your application's main event loop.

If you plan to call QTVRUpdate repeatedly for a movie instance, then for improved performance you should bracket those calls with calls to the QTVRBeginUpdateStream and QTVREndUpdateStream functions (described next).

SPECIAL CONSIDERATIONS

If you call QTVRUpdate after calling QTVRBeginUpdateStream but before calling QTVREndUpdateStream , the imagingMode parameter passed to QTVRUpdate must be the same as the imagingMode parameter passed to QTVRBeginUpdateStream . If you do not specify the same imaging mode to those two functions, an error will result.

SEE ALSO

Listing 2-4 illustrates the use of QTVRUpdate .

© 1997 Apple Computer, Inc.

| Previous | Chapter contents | Chapter top | Section top | Next |